home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
AmigActive 10
/
AACD 10.iso
/
AACD
/
Programming
/
mpatrol
/
man
/
cat1
/
mpatrol.1
< prev
next >
Wrap
Text File
|
2000-05-16
|
12KB
|
331 lines
MPATROL(1) mpatrol library MPATROL(1)
NNAAMMEE
mpatrol - runs programs using the mpatrol library
SSYYNNOOPPSSIISS
mmppaattrrooll [_o_p_t_i_o_n_s] <_c_o_m_m_a_n_d> [_a_r_g_u_m_e_n_t_s]
DDEESSCCRRIIPPTTIIOONN
The mmppaattrrooll command is used to set various mpatrol library
_o_p_t_i_o_n_s when running _c_o_m_m_a_n_d with its _a_r_g_u_m_e_n_t_s. In most
cases, _c_o_m_m_a_n_d must have been linked with the mpatrol
library, unless the _-_d option is used in which case _c_o_m_-
_m_a_n_d need only have been dynamically linked.
All mpatrol library diagnostics are sent to the file _m_p_a_-
_t_r_o_l_._%_n_._l_o_g in the current directory by default (where _%_n
is the current process id) but this can be changed using
the --ll option. Similarly, the default profiling output
filename is _m_p_a_t_r_o_l_._%_n_._o_u_t. Note that the LLOOGGAALLLL option
is always implicitly used for commands that are run by
this command.
OOPPTTIIOONNSS
All of the following options (except --dd and --VV) correspond
to their listed mpatrol library option. See mmppaattrrooll(3)
for more details on these options.
--11 <_u_n_s_i_g_n_e_d _i_n_t_e_g_e_r>
[SSMMAALLLLBBOOUUNNDD] Specifies the limit in bytes up to
which memory allocations should be classified as
small allocations for profiling purposes.
--22 <_u_n_s_i_g_n_e_d _i_n_t_e_g_e_r>
[MMEEDDIIUUMMBBOOUUNNDD] Specifies the limit in bytes up to
which memory allocations should be classified as
medium allocations for profiling purposes.
--33 <_u_n_s_i_g_n_e_d _i_n_t_e_g_e_r>
[LLAARRGGEEBBOOUUNNDD] Specifies the limit in bytes up to
which memory allocations should be classified as
large allocations for profiling purposes.
--AA <_u_n_s_i_g_n_e_d _i_n_t_e_g_e_r>
[AALLLLOOCCSSTTOOPP] Specifies an allocation index at which
to stop the program when it is being allocated.
--aa <_u_n_s_i_g_n_e_d _i_n_t_e_g_e_r>
[AALLLLOOCCBBYYTTEE] Specifies an 8-bit byte pattern with
which to prefill newly-allocated memory.
--CC <_u_n_s_i_g_n_e_d _r_a_n_g_e>
[CCHHEECCKK] Specifies a range of allocation indices at
which to check the integrity of free memory and
overflow buffers.
Release 1.2 16 May 2000 1
MPATROL(1) mpatrol library MPATROL(1)
--cc [CCHHEECCKKAALLLL] Specifies that all arguments to func-
tions which allocate, reallocate and deallocate
memory have rigorous checks performed on them.
--DD <_u_n_s_i_g_n_e_d _i_n_t_e_g_e_r>
[DDEEFFAALLIIGGNN] Specifies the default alignment for
general-purpose memory allocations, which must be a
power of two.
--dd Specifies that programs which were not linked with
the mpatrol library should also be traced, but only
if they were dynamically linked. This option will
only work if the system dynamic linker has the
ability to preload a set of user-specified shared
libraries via a special environment variable.
--ee <_s_t_r_i_n_g>
[PPRROOGGFFIILLEE] Specifies an alternative filename with
which to locate the executable file containing the
program's symbols.
--FF <_u_n_s_i_g_n_e_d _i_n_t_e_g_e_r>
[FFRREEEESSTTOOPP] Specifies an allocation index at which
to stop the program when it is being freed.
--ff <_u_n_s_i_g_n_e_d _i_n_t_e_g_e_r>
[FFRREEEEBBYYTTEE] Specifies an 8-bit byte pattern with
which to prefill newly-freed memory.
--GG [SSAAFFEESSIIGGNNAALLSS] Instructs the library to save and
replace certain signal handlers during the execu-
tion of library code and to restore them after-
wards.
--gg [UUSSEEDDEEBBUUGG] Specifies that any debugging informa-
tion in the executable file should be used to
obtain additional source-level information.
--LL <_u_n_s_i_g_n_e_d _i_n_t_e_g_e_r>
[LLIIMMIITT] Specifies the limit in bytes at which all
memory allocations should fail if the total allo-
cated memory should increase beyond this.
--ll <_s_t_r_i_n_g>
[LLOOGGFFIILLEE] Specifies an alternative file in which
to place all diagnostics from the mpatrol library.
--MM [AALLLLOOWWOOFFLLOOWW] Specifies that a warning rather than
an error should be produced if any memory operation
function overflows the boundaries of a memory allo-
cation, and that the operation should still be per-
formed.
--mm [UUSSEEMMMMAAPP] Specifies that the library should use
Release 1.2 16 May 2000 2
MPATROL(1) mpatrol library MPATROL(1)
mmmmaapp(()) instead of ssbbrrkk(()) to allocate system memory.
--NN [NNOOPPRROOTTEECCTT] Specifies that the mpatrol library's
internal data structures should not be made read-
only after every memory allocation, reallocation or
deallocation.
--nn [NNOOFFRREEEE] Specifies that the mpatrol library should
keep all reallocated and freed memory allocations.
--OO <_u_n_s_i_g_n_e_d _i_n_t_e_g_e_r>
[OOFFLLOOWWSSIIZZEE] Specifies the size in bytes to use for
all overflow buffers, which must be a power of two.
--oo <_u_n_s_i_g_n_e_d _i_n_t_e_g_e_r>
[OOFFLLOOWWBBYYTTEE] Specifies an 8-bit byte pattern with
which to fill the overflow buffers of all memory
allocations.
--PP <_s_t_r_i_n_g>
[PPRROOFFFFIILLEE] Specifies an alternative file in which
to place all memory allocation profiling informa-
tion from the mpatrol library.
--pp [PPRROOFF] Specifies that all memory allocations are
to be profiled and sent to the profiling output
file.
--QQ <_u_n_s_i_g_n_e_d _i_n_t_e_g_e_r>
[AAUUTTOOSSAAVVEE] Specifies the frequency at which to
periodically write the profiling data to the pro-
filing output file.
--RR <_u_n_s_i_g_n_e_d _i_n_t_e_g_e_r>
[RREEAALLLLOOCCSSTTOOPP] Specifies an allocation index at
which to stop the program when a memory allocation
is being reallocated.
--SS [SSHHOOWWMMAAPP & SSHHOOWWSSYYMMBBOOLLSS] Specifies that a memory
map of the entire heap and a summary of all of the
function symbols read from the program's executable
file should be displayed at the end of program exe-
cution.
--ss [SSHHOOWWFFRREEEEDD & SSHHOOWWUUNNFFRREEEEDD] Specifies that a summary
of all of the freed and unfreed memory allocations
should be displayed at the end of program execu-
tion.
--UU <_u_n_s_i_g_n_e_d _i_n_t_e_g_e_r>
[UUNNFFRREEEEDDAABBOORRTT] Specifies the minimum number of
unfreed allocations at which to abort the program
just before program termination.
Release 1.2 16 May 2000 3
MPATROL(1) mpatrol library MPATROL(1)
--VV Displays the version number of the mmppaattrrooll command.
--vv [PPRREESSEERRVVEE] Specifies that any reallocated or freed
memory allocations should preserve their original
contents.
--ww [OOFFLLOOWWWWAATTCCHH] Specifies that watch point areas
should be used for overflow buffers rather than
filling with the overflow byte.
--XX [PPAAGGEEAALLLLOOCC=_U_P_P_E_R] Specifies that each individual
memory allocation should occupy at least one page
of virtual memory and should be placed at the high-
est point within these pages.
--xx [PPAAGGEEAALLLLOOCC=_L_O_W_E_R] Specifies that each individual
memory allocation should occupy at least one page
of virtual memory and should be placed at the low-
est point within these pages.
--ZZ <_u_n_s_i_g_n_e_d _i_n_t_e_g_e_r>
[FFAAIILLSSEEEEDD] Specifies the random number seed which
will be used when determining which memory alloca-
tions will randomly fail.
--zz <_u_n_s_i_g_n_e_d _i_n_t_e_g_e_r>
[FFAAIILLFFRREEQQ] Specifies the frequency at which all
memory allocations will randomly fail.
SSEEEE AALLSSOO
mmlleeaakk(1), mmpprrooff(1), mmppaattrrooll(3).
The mpatrol manual, reference card and FAQ.
http://www.cbmamiga.demon.co.uk/mpatrol/
AAUUTTHHOORR
Graeme S. Roy <graeme@epc.co.uk>
CCOOPPYYRRIIGGHHTT
Copyright (C) 1997-2000 Graeme S. Roy <graeme@epc.co.uk>
This library is free software; you can redistribute it
and/or modify it under the terms of the GNU Library Gen-
eral Public License as published by the Free Software
Foundation; either version 2 of the License, or (at your
option) any later version.
This library is distributed in the hope that it will be
useful, but WITHOUT ANY WARRANTY; without even the implied
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE. See the GNU Library General Public License for
more details.
Release 1.2 16 May 2000 4
MPATROL(1) mpatrol library MPATROL(1)
You should have received a copy of the GNU Library General
Public License along with this library; if not, write to
the Free Software Foundation, Inc., 59 Temple Place, Suite
330, Boston, MA 02111-1307, USA.
Release 1.2 16 May 2000 5